home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / rnet107u.zip / RNET.DOC < prev    next >
Text File  |  1991-01-03  |  72KB  |  1,426 lines

  1.  
  2. RNET.DOC                                                                Page 1
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.    ╓──────┐ ╓────┐╓─┐ ╓─────┐ ╓─────┐
  10.    ║ ╒══╗ │ ║ ╒╗ │║ │ ║ ╒═══╛ ╚═╗ ╒═╛    Version: 1.07
  11.    ║ └──╜ │ ║ │║ │║ │ ║ └─┐     ║ │      Release: Jan 03 1991
  12.    ║ ╒═╗ ╒╛ ║ │║ │║ │ ║ ╒═╛     ║ │
  13.    ║ │ ║ └┐ ║ │║ └╜ │ ║ └───┐   ║ │      Copyright 1989,1990 Robert Vostreys
  14.    ╚═╛ ╚══╛ ╚═╛╚════╛ ╚═════╛   ╚═╛      All Rights Reserved
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.    PCBoard 14.x EchoConference driver for "QWK" packet based EchoNetworks.
  22.  
  23.  
  24.   _____________________________Naming Conventions____________________________
  25.  
  26.   RNet is distributed using the filenaming convention of:  RNETvvvx.zzz.
  27.   VVV refers to the version, such as '106' for version 1.06, '200' for
  28.   version 2.00.  The X refers to a letter code specifying alpha, beta,
  29.   registered, and shareware release versions.  Alpha and beta versions of
  30.   RNet begin at 'A' and continue no further than 'P'.  The registered release
  31.   version is distributed as RNETvvvR.zzz, the shareware release version is
  32.   distributed as RNETvvvU.zzz ('U' for unregistered).  The final ZZZ refers
  33.   to the compression utility extension, which will usually be .ARC or .ZIP or
  34.   whatever.  When referring to this distribution file in the documentation,
  35.   it will usually be referred to as "ZIP file."
  36.  
  37.  
  38.   _____________________________Distribution File_____________________________
  39.  
  40.      The following files should be present within the distribution ZIP file:
  41.  
  42.         RNET.EXE       Main executable program
  43.  
  44.         RNET.DOC       The documentation you are currently reading (RTFM!)
  45.         RNET_REF.DOC   Quick reference for RNet configuration and operation
  46.         REGISTER.DOC   Shareware registration form and information
  47.         CHANGES.vvv    Changes from version to version (history files)
  48.         ECHOS.DOC      Description and information about EchoConferencing
  49.         MESSAGES.DOC   Listing of errors which are not otherwise explained
  50.         RNETCONF.DOC   Information on PCBCONF and PROCONF interfacing
  51.         PCBCONF.EXE    Interface utility for PCBoard CNAMES conferences
  52.         PROCONF.EXE    Interface utility for ProDoor CONFINFO conferences
  53.  
  54.         SAMPLE1.CFG    Sample (verbose) configuration file with comments
  55.         SAMPLE2.CFG    Sample (brief) HOST_ID.CFG configuration file
  56.  
  57.         MAILRUN.BAT    Example BAT for making a host mail transfer
  58.         MAILRUN.SLT    Example Telix SALT for host mail transfers
  59.         PCBLOGIN.SLT   Example Telix SALT to login to host and open maildoor
  60.         LOWMEM.BAT     Example BAT for using external compression
  61.  
  62. RNET.DOC                                                                Page 2
  63.  
  64.   Alpha/Beta versions usually do not include the .DOC files but instead
  65.   include the CHANGES.vvv file for that version.  Please be sure to read this
  66.   file if you are working with an alpha or beta version of RNet!
  67.  
  68.  
  69.   _____________________________Distribution Rules____________________________
  70.  
  71.   Sysops MAY place 'ZIP Comments' on the RNet distribution ZIP file if they
  72.   normally do such with all their download files.
  73.  
  74.   Sysops MAY NOT place additional files (such as 'README.1ST' or 'BBS_AD')
  75.   within the distribution ZIP file nor may they use the PKZIP -AV
  76.   verification stamp.
  77.  
  78.   Distribution of the alpha, beta, and registered versions is restricted to
  79.   those systems with specific permission to distribute such.  Do not
  80.   distribute any version of RNet except the unregistered (RNETxxxU) version!
  81.  
  82.  
  83. RNET.DOC                                                                Page 3
  84.  
  85.  
  86.  
  87.   ___________________________Contacting the Author___________________________
  88.  
  89.   Problems, questions, and suggestions should be directed to Robert Vostreys:
  90.  
  91.      Modem:         Faster-Than-Light BBS
  92.                     Node1: 404-292-8761 [300 to 2400, non-MNP]
  93.                     Node2: 404-299-3930 [300 to 14400 USR HST]
  94.  
  95.      US Mail:       Robert Vostreys, FTL Sysop
  96.                     Post Office Box 2315
  97.                     Stone Mountain, GA  30086-2315
  98.  
  99.      EchoMail:      ILink:   Sysops, MM-RNet, or Admin EchoConferences.
  100.                     RIME:    Sysops or Admin EchoConferences (route ->FTL).
  101.                     Atlanta: AtlSysops or NetLANTA EchoConferences.
  102.  
  103.  
  104.   _________________________________Shareware_________________________________
  105.  
  106.   Since you have likely read statements under the heading "Shareware" often,
  107.   I'll not bother going into the idea again.  Simply be aware that RNet is
  108.   shareware ($20US suggested), the registered version has some additional
  109.   features, and that the file REGISTER.DOC contains the shareware
  110.   registration form and information.
  111.  
  112.   Any and all registered users may download and operate any later 1.xx
  113.   registered and beta versions of RNet as desired.  The registered and beta
  114.   versions are always available from these BBS's (all of which support Dual
  115.   Standard or 14400 USR HST connects):
  116.  
  117.                 Faster-Than-Light      404-292-8761 / 299-3930
  118.                 The Right Place<tm>    404-276-2607 / 476-0847
  119.                 Sleepy Hollow          213-859-9334
  120.                 Higher Powered BBS     408-737-9447
  121.                 Solutions BBS          804-471-2874 / 471-3487
  122.  
  123.  
  124. RNET.DOC                                                                Page 4
  125.  
  126.  
  127.  
  128.   __________________________________Overview_________________________________
  129.  
  130.   RNet is a utility to transfer messages from one BBS to another using the
  131.   QWK packet format.  The transfer/sharing of messages between BBS's is
  132.   commonly referred to as "EchoMail", "NetMail", or "EchoConferencing."  For
  133.   more information on echo network design and the terms used within this
  134.   document, see ECHOS.DOC.
  135.  
  136.   RNet will insert QWK packet messages into your PCBoard 14.x messagebases
  137.   and export new messages in a REP packet for insertion into a host system's
  138.   messagebases.  If you are familiar with the operation of EZ-Reader, Deluxe,
  139.   AmigaReader or similar QWK packet offline readers, most of the terms and
  140.   ideas used here will be familiar.
  141.  
  142.   The actual transfer of QWK/REP packets is left up to you and your choice of
  143.   communications programs.  Canned scripts and programs such as RoboComm will
  144.   work well to automate mail transfers.  A working example of a Telix SALT
  145.   script (MAILRUN.SLT) is included for your use and information.
  146.  
  147.   Usually, RNet is used in a system "event" to process incoming and outgoing
  148.   mail to a network host during the night (when long distance carrier rates
  149.   are lower).  RNet is designed to be extremely dependable, which may
  150.   substitute safety at the expense of speed.
  151.  
  152.   While RNet is for use with PCBoard 14.x (or ProDoor/ProBBS), your host need
  153.   not be running a PCBoard system.  TomCat! is an example of a WildCat! door
  154.   and MarkMail is an example of a PCBoard/ProDoor door.
  155.  
  156.   RNet is designed to be very verbose (both on-screen, error/warning reports,
  157.   report generation options, callerlog reporting in two formats), and even
  158.   shows on the Node Chat display when running.  If something goes wrong or
  159.   if a condition exists(ed) that warrants attention, a log entry will be made
  160.   to ERROR.LOG with any other information you might need.  There are a
  161.   variety of reports and logs that can be produced as desired.
  162.  
  163.  
  164. RNET.DOC                                                                Page 5
  165.  
  166.  
  167.  
  168.   ________________________________Feature List_______________________________
  169.  
  170.   Support for most (all?) QWK packet mail doors that support NetStatus.
  171.  
  172.   Limited to 32,765 conferences _per_ configuration / host QWK packet.
  173.   Limited to 32,765 conferences _per_ CNAMES or CONFINFO file (or create your
  174.   own conference location file (RNETCONF) using a text editor for complete
  175.   control.)
  176.  
  177.   You may have an unlimited number of hosts and configuration files.
  178.  
  179.   Complete multi-node concurrent access to local conferences supported -- you
  180.   will never lose a message due to concurrent messagebase insertions, even if
  181.   running RNet on several nodes concurrently importing into the same
  182.   messagebases.  Includes support for PCBoard 14.5 DOS 3.1 record locking.
  183.  
  184.   Support for PCBoard 14.x CNAMES (39 and 65534 conference versions) and
  185.   ProDoor CONFINFO (255 and 2040 conference versions).
  186.  
  187.   Always sends Host Sysop their private (R/O) messages. Always imports
  188.   private messages addressed to the Local Sysop.  This allows you and your
  189.   host to have a private conversation even in public-transfer-only
  190.   conferences/networks.
  191.  
  192.   Support for multiple hosts (using the same messagebases) with or without
  193.   cross echoing as desired.  This is useful for gateway connections between
  194.   two or more networks.
  195.  
  196.   Private (R/O) messages can be passed or limited on a global or conference-
  197.   by-conference basis.
  198.  
  199.   You may choose to honor or ignore the PCBoard 14.x "ECHO" flag.
  200.  
  201.   Completely definable tagline. The registered version of RNet allows you to
  202.   define the ENTIRE tagline (no software "id" involved -- what you define is
  203.   what you get!)
  204.  
  205.   A separate text-editable pointer file is maintained for each host.  Pointer
  206.   files are automatically backed up when a new REP packet is created.
  207.  
  208.   Special "Network Sysop" functions are supported to allow the network
  209.   administration to route very important messages to your MAIN BOARD if
  210.   needing such attention.
  211.  
  212.   Writes logs and pointer files to  the drive/directory where the
  213.   configuration file is found. This allows you to execute RNet from wherever
  214.   is convenient for your particular system configuration.
  215.  
  216.   Local display (processing screen) supports 25/43/50/60 line modes.
  217.  
  218.   Conference usage analysis reports showing activity in network conferences
  219.   and percentage of traffic generated locally.
  220.  
  221.   Message filtering: RNet will expand TABs, strip unneeded spaces, remove
  222.   bells/^S/^X, pack blank lines from taglines, and even decrypt John Hancock
  223.   encrypted taglines if desired.
  224.  
  225. RNET.DOC                                                                Page 6
  226.  
  227.  
  228.  
  229.   Handles and reports bad or corrupted PCBoard messagebases and NDX files.
  230.  
  231.   Automatically builds a pointer file for each host.  If you add a
  232.   conference, you need not reset a pointer as RNet will assume you want to
  233.   start at the high message number.
  234.  
  235.   Intelligent pointer handling.  If a pointer is set to a message lower than
  236.   the lowest message, RNet will reset the pointer to the low message.  If a
  237.   pointer is set above the high message, RNet will reset the pointer to the
  238.   high message.  You may safely change pointers to any value if needed (such
  239.   as to force export of an entire messagebase for a crashed host or to make a
  240.   backup).
  241.  
  242.   Warns you if you receive a conference in a QWK packet that you have not yet
  243.   configured on your end.
  244.  
  245.   Special commandline operations to force RNet to import/export only a single
  246.   specific conference or to "continue" importing in a QWK packet that stopped
  247.   for some reason (such as disk full).  No need to reprocess the entire
  248.   packet insertion!
  249.  
  250.   Automatic appending of messages to the REP packet if a REP packet is found
  251.   present when running an export.  This is can be enabled and is suggested
  252.   since it allows you to continue "building" on a REP even if your host is
  253.   busy or down.
  254.  
  255.   TCANNING of messages to/from specific users.  You can even TCAN messages
  256.   that are "from" a user, but not those "to" that user and/or vice-versa.
  257.  
  258.   Users (and the Sysop for that matter) can "watch" RNet's operation on the
  259.   Node Chat display in PCBoard. RNet looks like a normal "user". The "City"
  260.   display is used to relay what RNet is specifically doing at that time.
  261.  
  262.   Option to delete QWK packets after successful import automatically.  If an
  263.   import is unsuccessful, RNet will leave the QWK packet there for your
  264.   further investigation.
  265.  
  266.   Networks which support NETNEWS type conferences have a much easier time
  267.   with RNet.  RNet can automatically copy messages in special conferences
  268.   (such as Administration level conferences) into a NetNews conference.
  269.   Also, special messages (from a specific name/person, with a specific
  270.   keyword/subject) can be posted in the NetNews and transferred out along the
  271.   Administration level conferences.  This keeps ALL chitchat out of NetNews
  272.   style conferences.
  273.  
  274.   Automatic processing of multiple QWK packets (such as *.QWK, *.QW0,.. up to
  275.   *.QW9).  Useful if using a "pre-built" packet door such as QMail 4.xx which
  276.   may result in your downloading multiple packets for RNet to process.
  277.  
  278.   Automatic import speed determination.  RNet watches what other users are
  279.   doing via the USERNET.DAT file to decide how safe it is to import messages
  280.   quickly or safely.  If someone on another node (even another RNet) is
  281.   entering a message, RNet will flush the DOS directory structure after each
  282.   message for safety in importing messages.  Otherwise, RNet flushes after
  283.   each conference is completed.  Safety FIRST!
  284.  
  285.  
  286. RNET.DOC                                                                Page 7
  287.  
  288.  
  289.  
  290.   _________________________________NetStatus_________________________________
  291.  
  292.   NetStatus refers to your having the "permission" of a host system to echo a
  293.   messagebase (or bases).  You might have NetStatus on perhaps only one or
  294.   two conferences of that particular host's conferences -- that is up to the
  295.   discretion of your host.
  296.  
  297.   The host Sysop _must_ enable NetStatus for you before you can transfer any
  298.   messages back and forth!  Usually this is done with your being accepted
  299.   into an echo network such as ILink or SmartNet, or it may simply be that
  300.   you and another sysop wish to echo (transfer) a debate conference between
  301.   your boards.  Your host must enable NetStatus for your user record within
  302.   the maildoor you will be using for echoing messages.
  303.  
  304.   If you do not have NetStatus, RNet will write a log entry to ERROR.LOG and
  305.   skip the conference(s) in question.  If you are setting up for echomail and
  306.   do not yet have NetStatus on the host system, you will not be permitted to
  307.   import messages from the host system.  Exporting of messages with RNet will
  308.   correctly create a REP file, but they will not be accepted on the host
  309.   without NetStatus enabled.
  310.  
  311.  
  312.   _________________________________MailDoors_________________________________
  313.  
  314.   For RNet to process messages to/from a host system your host must support a
  315.   QWK packet format mail door.  This is where you will download QWK packets
  316.   (which contain new messages coming from the host/upper network) and upload
  317.   your REP packets (containing messages from your system/lower network).
  318.  
  319.   Each BBS running a mail door is assigned a HOST_ID.  If your host was, for
  320.   example, "Faster-Than-Light BBS", the assigned HOST_ID might be "FTL".
  321.  
  322.   Ask your host what the HOST_ID is if not obvious from within the mail door.
  323.  
  324.   When you request new messages from your host's mail door, a HOST_ID.QWK
  325.   packet will be constructed with new messages.  Using the above example, the
  326.   packet would be called FTL.QWK.
  327.  
  328.   When RNet collects new messages from your system to be sent up to the host,
  329.   it will create a HOST_ID.REP packet, such as FTL.REP.
  330.  
  331.   Different mail doors support different maximum conferences for echomail.
  332.   These limitations are for the number of conferences the HOST can support,
  333.   not how many conferences you might wish to have.  RNet always supports up
  334.   to 32765 conferences _per_ RNETCONF configuration on your system!  Host
  335.   conference support by door (as of November 1990):
  336.  
  337.       KMail v1.xx      Up to 32765 conferences available on the host system.
  338.       MarkMail v1.xx     '     256       ''          ''          ''
  339.       MarkMail v2.xx     '   32765       ''          ''          ''
  340.       QMail v2.xx        '     128       ''          ''          ''
  341.       QMail v3 & 4.xx    '     256       ''          ''          ''
  342.       TomCat! v1.xx      '     256       ''          ''          ''
  343.  
  344.  
  345. RNET.DOC                                                                Page 8
  346.  
  347.  
  348.  
  349.   ______________________________Echo Conferences_____________________________
  350.  
  351.   Echo conferences are the same as any normal conference on your board except
  352.   that the EchoFlag is used/supported.  In PCBSM/PROSM, create a conference
  353.   as normal.  Then, under the field asking about "Echo mail in conference",
  354.   specify YES.  Beyond that single difference, an Echo conference is the same
  355.   as any other (in setup that is).
  356.  
  357.   Be sure you specify enough "Index (NDX) blocks" to handle the inflow of
  358.   network message traffic.  If you pack your messagebases often (daily or
  359.   perhaps weekly), you can probably get away with one or two blocks.  If, on
  360.   the other hand, you want to keep a large number of messages on-hand or if
  361.   the traffic is extremely heavy (as with most debate conferences), you will
  362.   more than likely want to use four or perhaps six blocks.  Larger values
  363.   waste space unless you intend to keep 10,000 messages in a given conference
  364.   concurrently (or if you never pack the messagebases).
  365.  
  366.   Normally, messages entered in an Echo conference will not be echoed (send
  367.   out over the network) without the EchoFlag turned on.  When a user enters a
  368.   message, they will be prompted "Echo this message?"  If they specify YES,
  369.   then the message will be echoed.  If they specify No, then the message will
  370.   remain on the local system only.  Note that this can be overridden with the
  371.   "IGNOREECHO=" keyword in the HOST_ID configuration file.
  372.  
  373.  
  374.   ________________________________Commandline________________________________
  375.  
  376.   RNet needs only simple information on the commandline to operate.  Most of
  377.   the information RNet needs is derived from the HOST_ID.CFG configuration
  378.   file.  You need only tell RNet what kind of operation you want it to do
  379.   (such as IMPORT or EXPORT) and the HOST_ID.
  380.  
  381.      Commandline syntax:  RNET Operation HOST_ID [Param1 Param2]
  382.  
  383.      Operation must be one of:  EXPORT  IMPORT  SET  TOP.
  384.  
  385.   HOST_ID is *required* for all operations.  HOST_ID is specified for what
  386.   configuration, QWK, and REP packet filenames to look for and should not
  387.   contain an extension.  You should contact your Host Sysop to find out what
  388.   the HOST_ID is for your host's system.  Examples of HOST_ID include FTL,
  389.   TRP, EXECNET, CHEERS, HIGHER, and SEMWARE.
  390.  
  391.   Param1 and Param2 are used to specify additional information relating to
  392.   the operation being executed.  Param1, for example, is used to specify the
  393.   conference to use for SET and TOP operations.  See the text under each
  394.   operation for specific usage.
  395.  
  396.   If you neglect to specify an operation RNet will display a help screen to
  397.   remind you of the syntax.  On this screen you will see the copyright
  398.   notice, current version number, credits to Sysops who were helpful in
  399.   implementing or testing that version, and the Alpha, beta, registered, or
  400.   unregistered status.
  401.  
  402.  
  403. RNET.DOC                                                                Page 9
  404.  
  405.  
  406.  
  407.   ___________________________________EXPORT__________________________________
  408.  
  409.      Syntax:  RNET EXPORT HOST_ID [ONLY LocalConf#]
  410.  
  411.   Export instructs RNet to scan your messagebases for new outgoing messages
  412.   to be sent to your host.  Any new messages found will be placed in a
  413.   compressed HOST_ID.REP packet (appending or overwriting, depending on the
  414.   instructions in the HOST_ID.CFG configuration).  You would normally execute
  415.   this operation before calling your host for mail.
  416.  
  417.   If needed, you may specify ONLY and a local conference number which will
  418.   export new messages in the specified conference _only_.
  419.  
  420.   Examples:
  421.  
  422.      RNET EXPORT CHEERS       ;Export new messages for host CHEERS!
  423.      RNET EXPORT TRP          ;Export new messages for host TRP
  424.      RNET EXPORT TRP ONLY 5   ;Export only new messages in local conference 5
  425.  
  426.  
  427.   ___________________________________IMPORT__________________________________
  428.  
  429.      Syntax:  RNET IMPORT HOST_ID [ONLY|SKIPTO LocalConf#]
  430.  
  431.   Import is used to insert new messages from a QWK packet into your local
  432.   messagebases.  RNet will uncompress the HOST_ID.QWK packet(s), verify
  433.   NetStatus, and import the messages it finds.  You would normally execute
  434.   this operation after having downloaded mail from the host.
  435.  
  436.   There are two optional Param1 specifications accepted for the import
  437.   operation: ONLY and SKIPTO.  If either of these are specified you must also
  438.   specify a local conference number (Param2).
  439.  
  440.   ONLY allows you to import host messages in a specified conference.  This is
  441.   very useful for recovering from problems such as a disk full condition or
  442.   similar disaster.
  443.  
  444.   SKIPTO allows you to import host messages in conferences beyond a specified
  445.   local conference.  This is very useful for continuing an aborted import.
  446.   Simply look at the log to find the last imported conference then use that
  447.   local conference number as Param2.   RNet will then "pick up where it left
  448.   off" and continue importing host messages.
  449.  
  450.   Examples:
  451.  
  452.      RNET IMPORT CHEERS       ;Import messages from host CHEERS!
  453.      RNET IMPORT TRP          ;Import messages from host TRP
  454.      RNET IMPORT TRP ONLY 5   ;Import messages destined for conference 5
  455.      RNET IMPORT TRP SKIPTO 5 ;Resume aborted import at conference 5
  456.  
  457.  
  458. RNET.DOC                                                               Page 10
  459.  
  460.  
  461.  
  462.   ____________________________________SET____________________________________
  463.  
  464.      Syntax:  RNET SET HOST_ID LocalConf# PointerValue
  465.               RNET SET HOST_ID LocalConf# MessagesFromTop
  466.  
  467.   Though the host pointer file can be edited with a standard text editor
  468.   (such as QEdit or Edlin), you may change a messagebase pointer with the
  469.   commandline SET operation.  Specify Param1 as the local conference number
  470.   to change, Param2 as the value to change the pointer to.  If Param2 is
  471.   below the lowest numbered message, the lowest message will be used.  If
  472.   Param2 is above the highest message, the highest message number will be
  473.   used.  And finally, if Param2 is a negative value, RNet will use that value
  474.   subtracted from the highest (top) message number.
  475.  
  476.   Examples:
  477.  
  478.      RNET SET FTL 10 99999    ;set conf 10 pointer to high message.
  479.      RNET SET FTL 10 1        ;set conf 10 pointer to low message.
  480.      RNET SET FTL 10 -100     ;set conf 10 pointer to 100 from the top.
  481.  
  482.  
  483.   ____________________________________TOP____________________________________
  484.  
  485.   This works very similarly to the SET operation but has the advantage of
  486.   allowing you to change all the messagebase pointers at once.  If Param1 is
  487.   specified as a local conference number, RNet will reset that conference
  488.   pointer to the high message in that messagebase.  If Param1 is "ALL", RNet
  489.   will reset all conference pointers to the high message in each messagebase.
  490.  
  491.   Examples:
  492.  
  493.      RNET TOP TRP 1           ;set conf 1 pointer to last (top) message.
  494.      RNET TOP TRP ALL         ;set ALL conf pointers to top.
  495.  
  496.  
  497. RNET.DOC                                                               Page 11
  498.  
  499.  
  500.  
  501.   ___________________________Environment Variables___________________________
  502.  
  503.   RNet will look for and make use of the following environment variables.
  504.   Note that none of these environment variables are required, but are simply
  505.   searched for and used if RNet cannot find what it needs elsewhere.
  506.  
  507.   RNET=      Specify the D:\DIR\ where RNet should search for the HOST_ID.CFG
  508.              file.  RNet will first search the default (current) directory.
  509.              To maintain some compatibility with the old QNet 1.xx system,
  510.              RNet will look for the QWIKMAIL= environment if the RNET=
  511.              environment is not found.
  512.  
  513.              Example:  SET RNET=D:\PCB\RNET\
  514.  
  515.   RNETCONF=  Specify the complete D:\DIR\FILENAME that RNet should use for
  516.              its needed conference information (about your board).  If a
  517.              filename is not specified, RNet will use the RNETCONF= value as
  518.              a base drive/directory and search for RNETCONF there.  By
  519.              default, RNet looks for the file RNETCONF in the current
  520.              directory.  Use the RNETCONF= environment if you want RNet to
  521.              look elsewhere and/or if you want it to use a different filename
  522.              for RNETCONF.
  523.  
  524.              Example:  SET RNETCONF=D:\PCB\RNET\
  525.                or      SET RNETCONF=D:\PCB\RNET\RNETCONF.#2
  526.  
  527.   TMP=       Specify the D:\DIR\ where RNet should place working files (such
  528.              as the uncompressed QWK and REP packets).  The drive specified
  529.              must have enough space to handle your largest packet.  RNet will
  530.              also look for the TEMP= and QWORKDIR= environment variables, in
  531.              that order.  Note that the HOST_ID configuration keyword
  532.              WORKDIR= takes priority over the environment.  If you wish to
  533.              have RNet use one of these environment variables, neglect to put
  534.              WORKDIR= in the HOST_ID.CFG file.
  535.  
  536.              Example:  SET TMP=Z:\SCRATCH99\
  537.  
  538.   NODE=      The NODE= environment is used to tell RNet what node number it
  539.              is running on so that it can correctly update NODE CHAT and
  540.              CALLERS log.  The value must be from 0 to 99.  If NODE= is
  541.              specified in the HOST_ID.CFG, it takes precedence over the NODE=
  542.              environment.
  543.  
  544.              Example:  SET NODE=1
  545.  
  546.  
  547. RNET.DOC                                                               Page 12
  548.  
  549.  
  550.  
  551.   ____________________________Configuration Files____________________________
  552.  
  553.   For every host you will be echoing from you will need to create a
  554.   configuration [CFG] file.  You may create additional configuration files
  555.   and "switch them in and out" based on needs.
  556.  
  557.   A CFG file is a simple ASCII text file listing keywords and information.
  558.   RNet will parse the HOST_ID.CFG file (HOST_ID being what was given on the
  559.   commandline that specifies the net name of your host system) to get the
  560.   information it needs.
  561.  
  562.   RNet will first check the default directory, then look for a RNET=
  563.   environment variable (specifying a drive:\directory path) to try to find
  564.   the HOST_ID.CFG file.  If it fails to find the CFG file, RNet will abort
  565.   operation reporting "Configuration file not found!"
  566.  
  567.   Configuration files can and should be created with a standard text editor
  568.   such as QEdit or even Edlin.  Blank lines and lines beginning with a
  569.   semi-colon (";") will be ignored.  Each keyword should be specified on a
  570.   separate line and should have no trailing spaces between the keyword itself
  571.   and an equals ("=") sign that should follow.  Please see the example CFG
  572.   files included in this ZIP file for a template to use.
  573.  
  574.   In a future version a Configuration program will be included to ease the
  575.   configuration process.  Meanwhile, it is recommended that you use an
  576.   existing template (example) CFG file to work with -- simply use the DOS
  577.   COPY command to copy/rename a SAMPLE?.CFG to the needed HOST_ID.CFG
  578.   configuration file.
  579.  
  580.   Most keywords have synonym words (SYN) listed in the description.  These
  581.   alternate keywords have the same meaning as the base keyword and may be
  582.   used interchangably.
  583.  
  584.   The minimum keywords needed for any configuration file:
  585.  
  586.      HOSTSYSOP     (the host sysop name)
  587.      SYSOP         (your name)
  588.      HOSTORIGIN    (host system tagline)               [or HTAG0]
  589.      ORIGIN        (your system tagline)               [or TAG0]
  590.      CONF          (one per conference being echoed)   [or CONVERT]
  591.  
  592.   Highly recommended to be included in any configuration file:
  593.  
  594.      REPLYPROCESS  (so you know exactly what to expect)
  595.      WORKDIR       (or allow environment to specify)
  596.      NODE          (or allow environment to specify)
  597.      USERNET       (even if only specifying "NONE")
  598.  
  599.   You might do well using the example HOST_ID.CFG file as a base for creating
  600.   your configuration files.  Simply copy or rename the HOST_ID.CFG file to
  601.   the proper name for your host (replace HOST_ID with the node/netname of the
  602.   host maildoor, such as FTL or TRP, or EXECNET), then edit the file as
  603.   needed.  Remove any excess CONF statements to avoid exporting messages into
  604.   the wrong conferences!
  605.  
  606.  
  607. RNET.DOC                                                               Page 13
  608.  
  609.  
  610.  
  611.   _________________________Keywords: Names and Users_________________________
  612.  
  613.   HOSTSYSOP    Actual name of your host sysop.  This is the name that
  614.                incoming messages addressed to/from "SYSOP" on your host
  615.                systems board will be translated into.
  616.                SYN: HOST_SYSOP
  617.  
  618.   SYSOP        Your name.  Messages addressed to/from "SYSOP" on your system
  619.                will be translated into this name for outgoing messages.
  620.                SYN: LOCAL_SYSOP LOCALSYSOP
  621.  
  622.   MAKESYSOP    YES|NO; Should RNet address incoming mail to "SYSOP"?  If you
  623.                specify YES to this keyword, RNet will translate any incoming
  624.                messages addressed to/from your name into "SYSOP."
  625.                SYN: MAKE_SYSOP
  626.  
  627.   PRIVATEUSER  Up to 25 users may be specified as "private mail users".  Any
  628.                users specified by a PRIVATEUSER= entry in the CFG file will
  629.                be allowed to send private (R/O) messages despite the global
  630.                PRIVATE= setting.  Useful for moderators, hosts, net sysops,
  631.                and administration folks to send private messages up the
  632.                network.  Note that this does not change the settings of your
  633.                host's mail door -- private messages sent from the host are
  634.                controlled by the host.
  635.                SYN: PRIVATE_USER SPECIAL_USER PRIVATE_MAIL SPECIALUSER
  636.  
  637.                Example:  PRIVATEUSER=GEORGE CARLIN
  638.  
  639.   TCAN         You may specify up to 25 names (one full name  per line) which
  640.                RNet should refuse to process.  Any message addressed to/from
  641.                this user will not be imported or exported but instead written
  642.                to TCAN.LOG in the current directory.
  643.                SYN: TRASHCAN TRASH BADUSER BAD_USER
  644.  
  645.   TOCAN        You may specify up to 10 names with the TOCAN keyword (one
  646.                name per occurrence of TOCAN in the CFG file).  If a message
  647.                is addressed TO this name, RNet will refuse to import/export
  648.                it. As with TCAN, the refused messages are written to TCAN.LOG
  649.                for your review.
  650.                SYN: TRASHCAN_TO TO_TCAN
  651.  
  652.   FRCAN        The same as TOCAN except checks the name against the FROM
  653.                field for each message instead of the TO field.
  654.                SYN: TRANSHCAN_FROM FROMTCAN FROM_TCAN
  655.  
  656.  
  657. RNET.DOC                                                               Page 14
  658.  
  659.  
  660.  
  661.   HANDLE       Up to 25 handle/alias translations may be specified.  This
  662.                keyword allows translation of the user name in the TO/FROM
  663.                fields in two ways.  Because there are two forms for this
  664.                keyword it has confused folks in the past.  Hopefully, these
  665.                explanations and examples will help.
  666.  
  667.                Format:   HANDLE=AlwaysFromThis,AlwaysToThis
  668.                Example:  HANDLE=SPARKY,MARK HERRING
  669.  
  670.                    This example will translate "SPARKY" to "MARK HERRING".
  671.                    *Everytime* "SPARKY" is seen in the to/from fields of a
  672.                    message it will be changed into "MARK HERRING".  The name
  673.                    "SPARKY" will basically never appear locally or on the
  674.                    network, as it will *always* be changed to "MARK HERRING".
  675.  
  676.                    During     the name       is changed to
  677.                    ---------  -------------  -------------
  678.                    IMPORT     SPARKY         MARK HERRING
  679.                    IMPORT     MARK HERRING   MARK HERRING
  680.                    EXPORT     SPARKY         MARK HERRING
  681.                    EXPORT     MARK HERRING   MARK HERRING
  682.  
  683.                The second method of name translation allows you to change a
  684.                name one way during import and the other during export.  Thus,
  685.                you can specify how a name appears on your board which is
  686.                different from the way it appears over the network.  Note the
  687.                addition of the asterisk in the following example:
  688.  
  689.                Format:   HANDLE=*ExportAsThis,ImportAsThis
  690.                Example:  HANDLE=*SPARKY,MARK HERRING
  691.  
  692.                    The asterisk is used to signify that you wish the
  693.                    translation to "reverse" when doing an export.  Anytime
  694.                    the name "SPARKY" or "MARK HERRING" is seen during an
  695.                    import, it is changed into "MARK HERRING".  Anytime
  696.                    "SPARKY" or "MARK HERRING" is seen during an export it is
  697.                    instead changed into "SPARKY".
  698.  
  699.                    During     the name       is changed to
  700.                    ---------  -------------  -------------
  701.                    IMPORT     SPARKY         MARK HERRING
  702.                    IMPORT     MARK HERRING   MARK HERRING
  703.                    EXPORT     SPARKY         SPARKY
  704.                    EXPORT     MARK HERRING   SPARKY
  705.  
  706.                    Thus the name "SPARKY" will always appear over the network
  707.                    while the name "MARK HERRING" will always appear on your
  708.                    board.
  709.  
  710.                Use HANDLE=Name1,Name2 when you *always* want 'Name1' to
  711.                be changed into 'Name2'.
  712.  
  713.                Use HANDLE=*Name1,Name2 when you want 'Name1' to appear
  714.                on the network and 'Name2' to appear on your board.
  715.  
  716.                SYN: ALIAS NAME_CHANGE
  717.  
  718. RNET.DOC                                                               Page 15
  719.  
  720.  
  721.  
  722.  
  723.   _____________________________Keywords: Taglines____________________________
  724.  
  725.   Taglines are always forced into a standard format.  Before the first
  726.   tagline that is to appear on a message, a tearline must appear.  A tearline
  727.   is composed of a line with three dashes ("---") optionally followed by
  728.   additional text (FidoNet compatable method).  All taglines follow this
  729.   tearline and begin with either " ■ " or " * ".  RNet will automatically fix
  730.   taglines from other software packages that do not conform to this standard
  731.   and will remove blank lines from between taglines.  RNet will automatically
  732.   chop off any taglines in excess of two.
  733.  
  734.   HOSTORIGIN   Use HOSTORIGIN to specify what tagline to place on messages
  735.                that originate from your HOST system.  The host's mail door
  736.                does not place any taglines on messages, it is up to your end
  737.                of things.  The tagline should conform to whatever network
  738.                standards are currently in effect.  Note that the synonym
  739.                HTAG0 is commonly used instead of HOSTORIGIN.
  740.                SYN: HTAG0 HOST_ORIGIN HOST_TAG HOST_TAGLINE HOSTTAG
  741.  
  742.                Example:  HOSTORIGIN= ■ Host board name ■ City ■ Phone Number
  743.  
  744.   HTAG0..9     The ten HTAGx statements allow you to specify up to ten
  745.                different host taglines.  HTAG0 is the same as HOSTORIGIN and
  746.                may be used in place of it.  To specify which of these ten
  747.                taglines is to be used as the host tagline on any given
  748.                conference, see the CONF statement below.
  749.  
  750.   ORIGIN       ORIGIN is used to specify the tagline to be placed on messages
  751.                coming from your system.  All messages exported from your
  752.                system that originated from your system will have this tagline
  753.                placed on them.  The tagline should conform to the network
  754.                standards of the network in question.
  755.                SYN: TAG0 TAGLINE LOCALTAG LOCAL_TAG
  756.  
  757.                Example:  ORIGIN= * BBS Name, City, Phone Number
  758.  
  759.   TAG0..9      The ten TAGx keywords allow you to specify up to ten different
  760.                taglines for messages originating from your system.  TAG0 is a
  761.                replacement for ORIGIN and can be used in place of it.  To
  762.                specify which of these ten taglines are to be used for each
  763.                specific conference, see the CONF statement.
  764.  
  765.   FORCETAG     YES|NO.  If you specify YES for this keyword, RNet will
  766.                *always* append a tagline (host or origin, as appropriate) on
  767.                all messages processed.  Note that if the tagline addition
  768.                causes more than two taglines to be appended to the message,
  769.                any in excess of two will be stripped.  This is used mostly
  770.                for forcing tagging of messages for debugging use.
  771.                SYN: FORCE_TAG FORCE
  772.  
  773.                Default: NO (disabled; add tagline only when/if needed)
  774.  
  775.  
  776. RNET.DOC                                                               Page 16
  777.  
  778.  
  779.  
  780.   FORCENOTAG   YES|NO.  Specify YES to this keyword if you want to force RNet
  781.                *not* to append any taglines to any messages processed.  In
  782.                smaller and in-company business echo networks, you might
  783.                desire to have no taglines.
  784.                SYN: NOTAG FORCE_NO_TAG
  785.  
  786.                Default: NO (disabled; add tagline if needed)
  787.  
  788.   RTAG         YES|NO|ORIGIN.  The RTAG keyword enables (YES) or disables
  789.                (NO) the " ■ RNet v.vvx: " on the beginning of each tagline.
  790.                If RTAG=ORIGIN is specified, RNet will use the Fido standard
  791.                " * ORIGIN: " at the beginning of the line and append ":RNet
  792.                v.vvx" to the end.  Note that this keyword is subject to
  793.                different effects depending on the version/release of RNet:
  794.  
  795.                  Alpha/Beta: specifying NO changes the tagline id to a
  796.                  shorter id (" ■ Rvvvx:").  This information is used for
  797.                  debugging (watching) RNet operate over several large
  798.                  networks where strict control is not possible.
  799.  
  800.                  Unregistered: RTAG=YES and RTAG=NO have no effect.
  801.  
  802.                  Registered: specifying RTAG=NO will completely remove the
  803.                  " ■ RNet" part of the tagline.  In this case, the text you
  804.                  specify for host/origin (HTAGx and TAGx) taglines will be
  805.                  the *complete* text used for the taglines.
  806.  
  807.                SYN: RNETTAG RNET_TAG R_TAG
  808.  
  809.   FIXJH        YES|NO.  This keyword tells RNet if it should automatically
  810.                decrypt encrypted John Hancock version 2.xx taglines.  Some
  811.                networks do not allow encrypted taglines so this option allows
  812.                you to decrypt them automatically.  If you specify FIXJH=YES,
  813.                both incoming and outgoing messages will be checked and
  814.                decrypted.
  815.                SYN: FIX_JH_TAGS
  816.  
  817.                Default: NO (leave encrypted JH taglines alone)
  818.  
  819.  
  820.   ________________________Keywords: Packet Processing________________________
  821.  
  822.   COMPRESS     Specify the program and options needed to compress a REP
  823.                packet for sending to your host.  Check with your host about
  824.                what program/method should be used for packet compression
  825.                (most commonly PKZIP).  All appropriate filenames will be
  826.                added to this command when RNet calls it, so only specify the
  827.                command and switches (if any) needed.  NOTE: If the program
  828.                needed is not in the current directory or along the DOS PATH=
  829.                environment, specify the complete d:\dir\filename.ext.
  830.                SYN: PKPAK ARC PAK PKZIP ZIP
  831.  
  832.                Default:  PKZIP -m -ex
  833.  
  834.  
  835. RNET.DOC                                                               Page 17
  836.  
  837.  
  838.  
  839.   UNCOMPRESS   Specify the command (program) needed to uncompress an incoming
  840.                QWK packet from your host.  Check with your host as to what
  841.                program is needed.  The command must accept placing of a
  842.                directory specification on the end (last parameter) for RNet
  843.                to place the files in the work directory.  If this does not
  844.                work correctly (ie, is not supported by the decompression
  845.                program), you will need to remove all references (CFG and
  846.                environment) to WORKDIR= so RNet uses the current directory.
  847.                SYN: PKUNPAK UNARC UNPAK PKUNZIP UNZIP
  848.  
  849.                Default:  PKUNZIP -o
  850.  
  851.   WORKDIR      Use WORKDIR to specify the drive/directory where RNet should
  852.                place scratch files and uncompressed QWK packets.  If you have
  853.                a large enough RAM drive, specify that.  When RNet is done
  854.                processing, it will only delete the files it created or
  855.                uncompressed, thus, you may even use the current directory
  856.                safely if desired.
  857.  
  858.                Note that the drive/directory pointed to by WORKDIR must
  859.                already exist or RNet will report an error. A recommended
  860.                drive/directory would be the "play" or "scratch" directory
  861.                used by the processing node for up/download processing.
  862.  
  863.                This setting (WORKDIR) overrides the TMP= environment.
  864.  
  865.   REPLYPROCESS APPEND|OVERWRITE.  Specify APPEND for this keyword if you want
  866.                RNet to append new outgoing messages to an existing REP
  867.                packet.  This allows you to keep adding to the end of a REP
  868.                packet when your host has been busy.
  869.  
  870.                *WARNING*: if you use this option, you must delete your
  871.                HOST_ID.REP packet after successful upload to your host.
  872.                Failure to do so will result in uploading duplicate messages!
  873.                SYN: REPLY_PROCESS
  874.  
  875.                Default:  Delete (overwrite) existing HOST_ID.REP packets.
  876.  
  877.   ARCHIVE      The only option for this keyword is EXTERNAL and should only
  878.                be specified if you are prepared to handle it.  If you specify
  879.                ARCHIVE=EXTERNAL, RNet will not shell to DOS to execute the
  880.                COMPRESS and UNCOMPRESS commands, but will instead assume that
  881.                you are going to handle these functions before and after
  882.                calling RNet.  If you are in a tight memory situation, you
  883.                will likely need to use this option.  Please see LOWMEM.BAT
  884.                for more information and an example of how to handle
  885.                compression/decompression in this manner.
  886.  
  887.   QWKPATH      Specify the d:\dir\ where RNet should look for QWK packets
  888.                from your host.  RNet will automatically process multiple
  889.                packets (HOST_ID.QW?) if found, in numerical order.  You
  890.                should use this keyword to point to the download d:\dir\ that
  891.                your terminal communications program downloads QWK packets to.
  892.                SYN: QWK QWKS QWK_PATH QWKPACKETS QWK_PACKETS
  893.  
  894.                Default:  Current drive/directory
  895.  
  896. RNET.DOC                                                               Page 18
  897.  
  898.  
  899.  
  900.   REPPATH      Use this keyword to specify the d:\dir\ where RNet should
  901.                create HOST_ID.REP packets for sending to your host.  Usually
  902.                this will be the d:\dir\ where your terminal program expects
  903.                to find files for uploading.
  904.                SYN: REPLOC REP_PATH REPDIR REP_DIR
  905.  
  906.                Default:  Current drive/directory
  907.  
  908.   KILLQWK      YES|NO.  The KILLQWK keyword allows you to instruct RNet to
  909.                delete the HOST_ID.QWK packets after *successful* import.  If
  910.                anything goes wrong or if RNet has reported any warnings, the
  911.                packet will not be deleted.  This can be useful for your event
  912.                batch file to figure out if the import process proceeded
  913.                without any problems simply by looking for the existence of
  914.                *.QW? after import processing.  If *.QW? exists, something
  915.                went wrong.  If you do not use this option, be sure to
  916.                manually delete or move the packet before your next mailrun to
  917.                avoid inserting duplicate messages.
  918.                SYN: KILL_QWK DELETEQWK DELETE_QWK
  919.  
  920.                Default:  NO (QWK packets are not automatically deleted)
  921.  
  922.   CHECKREP     YES|NO.  If you wish, RNet can check for, and prompt you for
  923.                what to do with an existing REP packet (during both IMPORT and
  924.                EXPORT setup operations) when it finds one.  Specify
  925.                CHECKREP=YES to have RNet look for any existing REP packets,
  926.                and if one exists, prompt you to:  Delete the packet and
  927.                continue;  Retain the packet and abort operation; Continue
  928.                normally (default).  RNet will wait for 10 seconds for you to
  929.                make a decision.  This option is available so that if you do
  930.                manual processing of a mailrun, you will be prompted about the
  931.                disposition of any existing REP packets that you may have
  932.                forgotten to manually delete.
  933.                SYN: CHECK_REP
  934.  
  935.                Default:  NO (do not prompt operator for REP disposition)
  936.  
  937.   CKPOINTERS   YES|NO.  By default, RNet will automatically check all its
  938.                current pointers against the existing messagebases (which can
  939.                take a minute or two if you have 2000+ echo conferences).  If
  940.                it finds a problem, it will automatically correct the pointer
  941.                file.  Pointers are checked against the current High and Low
  942.                message numbers in the conference messagebase to determine
  943.                that the pointer is valid.  You may specify CKPOINTERS=NO to
  944.                disable this safety feature (this is *not* recommended!).
  945.                SYN: CHECKPOINTERS CHECK_POINTERS
  946.  
  947.                Default: YES (check all pointers every time RNet is run)
  948.  
  949.  
  950. RNET.DOC                                                               Page 19
  951.  
  952.  
  953.  
  954.   _________________________Keywords: Message Handling________________________
  955.  
  956.   PRIVATE      YES|NO.  This is a global specification as to if private (R/O)
  957.                messages are allowed on the network in question.  If the
  958.                network you are connecting to allows *all* users in *all*
  959.                conferences to send private (R/O) messages, specify
  960.                PRIVATE=YES.  Note that RNet will honor the PCBoard/ProDoor
  961.                conference configuration (PCBSETUP/PROSM) which specifies that
  962.                all messages should be private (R/O) regardless of this
  963.                keyword setting.  Use PRIVATE=NO and PRIVATECONF (see below)
  964.                to specify private messages are allowed only in specific
  965.                conferences.
  966.                SYN: SENDPRIVATE SEND_PRIVATE
  967.  
  968.                Default: NO (send only public messages)
  969.  
  970.   COMMENTS     YES|NO.  This keyword specifies if Sysop COMMENT security
  971.                messages should be exported.  This is useful if you are
  972.                running multiple BBS's and want to send all messages from one
  973.                system to another via RNet.  Note that PRIVATE must be
  974.                specified YES as well for this option to be in effect.
  975.                SYN: SENDCOMMENTS SEND_COMMENTS
  976.  
  977.                Default: NO (do not send COMMENT security messages)
  978.  
  979.   PRIVATECONF  You may specify a list of local conference numbers (separated
  980.                by commas) in which private messages are permitted to be
  981.                transmitted.  This option is added such that you may have a
  982.                network which only allows private (R/O) messages in certain
  983.                conferences.  You may specify as many PRIVATECONF statements
  984.                as needed or desired.  Note that using PRIVATE=YES is the
  985.                global of this keyword.
  986.                SYN: PRIVATE_CONF
  987.  
  988.                Example:  PRIVATECONF=1,10,11,12,200,201
  989.  
  990.   IGNOREECHO   As with PRIVATECONF, you may specify a list of conferences
  991.                (ie, by local conference number) in which you want to ignore
  992.                the PCBoard 14.x EchoFlag status.  This is useful if you have
  993.                an automated process or another mail package that turns off
  994.                the EchoFlag for some reason and you want to export the
  995.                messages despite the EchoFlag.  Normally, RNet will not export
  996.                messages that do not have the EchoFlag specifically enabled on
  997.                them.
  998.                SYN: IGNORE_ECHO
  999.  
  1000.                Example:  IGNOREECHO=5,6,7,10,11,12,200,201
  1001.  
  1002.   ANSICONF     This keyword is used to enable ANSI escape sequences in any
  1003.                given conference(s).  List conferences by local conference
  1004.                number (as with IGNOREECHO above).  RNet will "fix" translated
  1005.                (filtered) ANSI sequences when it can in these conferences.
  1006.                SYN: ANSI ACCEPT_ANSI
  1007.  
  1008.  
  1009. RNET.DOC                                                               Page 20
  1010.  
  1011.  
  1012.  
  1013.   KEYCODE      KEYCODE is used to support multiple or cross echoed networks
  1014.                within the same conferences.  KEYCODE specifies a single
  1015.                character, preferably one of !, @, #, $, %, ^, &, or a single
  1016.                alphanumeric character, which is to be used to specify the
  1017.                network of origin of a message.
  1018.  
  1019.                If you are only echoing a single network or if you are not
  1020.                involved in cross echoing of multiple networks into the same
  1021.                conferences (ie, not a 'gateway'), simply specify KEYCODE=! or
  1022.                something similar (DO NOT USE "*") and ignore the rest of this
  1023.                description.
  1024.  
  1025.                Specify a different KEYCODE for each network you will be
  1026.                echoing.  For example, if echoing ILink, you might specify
  1027.                KEYCODE=I, and for CanConfMail, specify KEYCODE=C.  Doing
  1028.                this, if you echo both networks into the same physical
  1029.                conference, messages from either network will be sent out to
  1030.                the other automatically (along with all replies and messages
  1031.                coming from "lower" on the networks).  This is known as a
  1032.                'Gateway' connection.
  1033.  
  1034.                If you wish to import multiple networks into the same
  1035.                conference and do not want to send the messages from one
  1036.                network to the other, specify the same KEYCODE for both
  1037.                networks (such as KEYCODE=! for in both configurations).  In
  1038.                this case (both KEYCODEs being the same), messages from one
  1039.                network host will *not* be sent to the other while all
  1040.                messages originating from your board (or lower on the
  1041.                network(s)) *will* be exported to both network hosts.  Not
  1042.                likely desired or needed, but the ability is there.
  1043.  
  1044.                Basic logic description:  All messages imported will have the
  1045.                defined KEYCODE assigned to them.  During export processing,
  1046.                any messages that have the exact KEYCODE on them will not be
  1047.                exported (thus avoiding bouncing messages back up the net).
  1048.                Messages sent up to your board from lower on the network will
  1049.                always have a keycode of "*".  If you did not want to send
  1050.                messages from lower on the network up the network (who knows
  1051.                why you would want to do this?!), specify a KEYCODE of "*".
  1052.                SYN: BBSKEY BBS_KEY BBS_KEYCODE
  1053.  
  1054.                Example:  KEYCODE=!
  1055.  
  1056.   ___________________________Keywords: Conferences___________________________
  1057.  
  1058.   CONF         You must specify one CONF statement for every echo conference
  1059.                you are intending to echo with your host.  The CONF keyword is
  1060.                used to specify how your local conference numbers correspond
  1061.                to the host's conference numbers.  You may also use it to
  1062.                specify an alternate tagline to be used for each conference
  1063.                (see HTAG0..9 and TAG0..9 above).  Commonly, the synonym
  1064.                CONVERT is used for CONF.
  1065.  
  1066.                Format:  CONF=Local#,Host#:Tag#
  1067.  
  1068.                Note that the ":Tag#" part of the CONF statement is optional
  1069.  
  1070. RNET.DOC                                                               Page 21
  1071.  
  1072.  
  1073.                and only needed if you wish to specify using taglines other
  1074.                than HTAG0 and TAG0 (see HTAG0..9 above).
  1075.  
  1076.                You may place "comments" after the CONF statement (avoid using
  1077.                a ":" in the comment!) such as listing the conference name.
  1078.                The examples below are valid as they are.  See also the
  1079.                SAMPLE?.CFG files.
  1080.                SYN: CONVERT CONFERENCE
  1081.  
  1082.                Example:  CONF=1,55      (my 1 = host 55, use H/TAG0 tags)
  1083.                Example:  CONF=2,56:0    (my 2 = host 56, use H/TAG0 tags)
  1084.                Example:  CONF=3,60:1    (my 3 = host 60, use H/TAG1 tags)
  1085.                Example:  CONF=4,61:1    (my 4 = host 61, use H/TAG1 tags)
  1086.                Example:  CONF=5,62:1    (Sysops Echo)
  1087.  
  1088.  
  1089.   _____________________________Keywords: NetNews_____________________________
  1090.  
  1091.   NetNews keywords are used to allow a network to support a special "NetNews"
  1092.   type conference that has only special news messages from the network
  1093.   administration.  The philosophy behind the RNet NetNews conference support
  1094.   is to create a conference that is not echoed, but instead has messages
  1095.   inserted in it that come from another conference.  The messages inserted
  1096.   into this special NetNews conference are designated by key words and users
  1097.   as defined by the following keywords.  Ask your network administration if
  1098.   this form of NetNews conference support is available and/or simply monitor
  1099.   the administration conferences and figure out for yourself what "special"
  1100.   messages should be extracted into a special conference (presumably, public
  1101.   for all users to read).
  1102.  
  1103.   All messages imported/exported in the NETADMIN conference are checked.  Any
  1104.   message that is addressed to ALL, addressed from NETADMIN, and the subject
  1105.   contains the text specified by NETSUBJECT, will be copied to the NETNEWS
  1106.   conference as public and non-echo.
  1107.  
  1108.   NETNEWS      Specify the local conference (by number) to be used as the
  1109.                destination for NetNews type messages.  Messages which match
  1110.                the parameters specified by the other keywords will be copied
  1111.                into this conference.  This will commonly NOT be an echo
  1112.                conference and usually has the "Make all messages private"
  1113.                option turned on in PCBSM/PROSM.  RNet will insert messages
  1114.                here as public (despite the "Make private" setting).
  1115.                SYN: NET_NEWS NET_NEWS_CONF
  1116.  
  1117.                Example:  NETNEWS=15     (use local conference 15 for NetNews)
  1118.  
  1119.   NETADMIN     Specify a local conference number that is normally used for
  1120.                Administration level messages.  This conference will be
  1121.                checked during processing for messages that match NETADMINID
  1122.                and NETSUBJECT.  Messages which match the requirements will be
  1123.                copied to the NETNEWS conference.  The original messages will
  1124.                still be imported/exported in this conference so that it is
  1125.                passed to other systems up and down the network.
  1126.                SYN: NET_ADMIN NET_ADMIN_CONF
  1127.  
  1128.                Example:  NETADMIN=44    (search conf 44 for NetNews messages)
  1129.  
  1130.  
  1131. RNET.DOC                                                               Page 22
  1132.  
  1133.  
  1134.   NETADMINID   Use this keyword to specify the name that a message must be
  1135.                FROM to qualify as a NetNews message.  Usually this is either
  1136.                a special alias (such as "Network Administration") or someone
  1137.                in the administration. The message in question must also be
  1138.                addressed to "ALL" to qualify -- this keeps replies and other
  1139.                comments from appearing in the NetNews conference.
  1140.                SYN: NET_ADMIN_ID NETADMIN_NAME NET_ADMIN_NAME
  1141.  
  1142.                Example:  NETADMINID=NETWORK ADMINISTRATION
  1143.  
  1144.   NETSUBJECT   Messages in the NETADMIN conference are checked, and assuming
  1145.                the message matches the NETADMINID the NETSUBJECT is checked.
  1146.                Specify a key phrase or word that must appear in the subject
  1147.                of the message to qualify as a NetNews message.  Usually this
  1148.                is something along the lines of "** ANNOUNCEMENT **".  The
  1149.                subject need not match exactly, but must contain the phrase or
  1150.                words specified with this keyword (which is *not* case
  1151.                sensitive).
  1152.                SYN: NET_SUBJECT
  1153.  
  1154.                Example:  NETSUBJECT=** ANNOUNCEMENT **
  1155.  
  1156.   Logic example:  Using the examples above, if a message appears in local
  1157.   conference 44 (either during import or export processing, so it works even
  1158.   when the message is going "up" the network) is addressed to "ALL", is from
  1159.   "NETWORK ADMINISTRATION" and has the text "** ANNOUNCEMENT **", that
  1160.   message will be copied to local conference 14 as public and non-echo.
  1161.  
  1162.  
  1163.   ________________________Keywords: Multinode/NodeChat_______________________
  1164.  
  1165.   If you are running a multinode system concurrently with your RNet event
  1166.   processing (which is perfectly safe by the way), you should specify the
  1167.   following keywords to help RNet determine how to proceed.  RNet honors and
  1168.   will check the PCBoard messagebase LOCKED field when inserting messages in
  1169.   all cases.  Assuming you specify these keywords correctly, you may "watch"
  1170.   RNet processing via the NODE CHAT display.
  1171.  
  1172.   NODE         This keyword, when used, will override the environment
  1173.                variable NODE.  If you specify a value of 1-99, RNet will
  1174.                "login" to that node as far as the Node Chat and CALLERS logs'
  1175.                are concerned (see CALLERLOG below).  Specify a value of 0 and
  1176.                USERNET=NONE if running a single node system.  Specify a value
  1177.                of 0 and correctly specify USERNET=d:\dir\usernet.dat to have
  1178.                RNet use the NODE= environment.
  1179.                SYN: PCB_NODE NODE_NUMBER PCBNODE NODENUMBER
  1180.  
  1181.                Example:  NODE=3  (mail events are processed by node 3)
  1182.  
  1183.   USERNET      Specify the d:\dir\filename.ext of the PCBoard node chat
  1184.                USERNET.DAT file.  RNet will show up as a node on the Node
  1185.                Chat display reporting exactly what it is doing (Init,
  1186.                Exporting xxx, Importing xxx, Cleanup, etc) via the city/state
  1187.                field.  RNet must have this keyword specified correctly for
  1188.                its automatic speed selection from fast/slow.  If RNet sees a
  1189.                user on another node who is: Unavailable, Entering a message,
  1190.                or Out of code in door, then RNet will use a slow (safer)
  1191.  
  1192. RNET.DOC                                                               Page 23
  1193.  
  1194.  
  1195.                concurrent message entry routine.  If all users are Available
  1196.                or doing other things, RNet will use a faster insertion
  1197.                routine (it will not flush the directory structure between
  1198.                each message).
  1199.  
  1200.                If running a single node system specify USERNET=NONE.
  1201.                SYN: NETUSER NETUSERS NETDATA NETINFO
  1202.  
  1203.                Example:  USERNET=D:\PCB\MAIN\USERNET.DAT
  1204.  
  1205.   _____________________________Keywords: Reports_____________________________
  1206.  
  1207.   CONFREPORT   Specify the complete d:\dir\filename.ext that RNet should
  1208.                write the conference analysis report to.  This report shows
  1209.                each configured conference, number of messages exported/
  1210.                imported, locally created, percentages comparisons to traffic
  1211.                locally and netwide.  Very handy report to keep around!
  1212.                SYN: CONF_REPORT REPORTFILE REPORT_FILE
  1213.  
  1214.                Example:  CONFREPORT=D:\PCB\GEN\BLT20
  1215.  
  1216.   SUPERLOG     If you want this report, specify a d:\dir\filename.ext for
  1217.                this keyword.  The SUPERLOG (aka ALLMESSAGELOG), is a listing
  1218.                of every message imported or exported by conference, message
  1219.                number, subject, date, addressed to and from.  This log can
  1220.                quickly eat up valuable disk space (similar to the way a
  1221.                CALLERS log can), so don't let it sit around without attention
  1222.                too long.
  1223.                SYN: ALLMESSAGELOG
  1224.  
  1225.                Example:  SUPERLOG=D:\PCB\GEN\ALLMSGS.LOG
  1226.  
  1227.   DAILY        YES|NO.  Enable or disable the daily report analysis logging.
  1228.                RNet will normally create a log report listing each conference
  1229.                and the number of imported/exported messages.  These reports
  1230.                are automatically maintained for the last six days based on
  1231.                the day of the week.  The files created are in the default
  1232.                directory named VERBOSE.XXX where XXX is the day of the week
  1233.                (such as SUN, MON, TUE).  RNet always deletes "tomorrow's"
  1234.                report so that the reports do not consume excess drive space.
  1235.                Specify NO if you want to disable this reporting function.
  1236.                SYN: DAILYLOG DAILY_LOG
  1237.  
  1238.   CALLERLOG    If you want RNet to report the number of messages imported and
  1239.                exported in each conference to the CALLERS log, use CALLERLOG
  1240.                to specify the d:\dir\filename.ext for your CALLERS log file.
  1241.                If you are running a multinode system, do NOT include the node
  1242.                number on the end of the file as RNet will automatically
  1243.                append this.  If running a single node system (ie, NODE=0),
  1244.                RNet will not append a node number to the filename.  RNet will
  1245.                report itself logging in, a baud rate of (Event), Graphics on,
  1246.                and IMPORT or EXPORT for the city/state field.  Next, it will
  1247.                list each conference that has at least one message of traffic
  1248.                in it and the total number of messages imported or exported.
  1249.                Finally, RNet will report the number of minutes used and
  1250.                logoff "normally" (if that is the case).
  1251.                SYN: CALLER_LOG CALLERS
  1252.  
  1253. RNET.DOC                                                               Page 24
  1254.  
  1255.  
  1256.  
  1257.                Example:  CALLERLOG=D:\PCB\MAIN\CALLERS
  1258.  
  1259.   LONGCALLER   YES|NO.  If you specify YES for this keyword, the CALLERLOG
  1260.                report will be much more verbose.  The LONGCALLER report lists
  1261.                every message imported/exported as if a "user" had left the
  1262.                messages in the first place.  This can be useful for caller
  1263.                analysis programs to know exactly how much message traffic is
  1264.                occuring in each conference.
  1265.                SYN: VERBOSECALLERLOG VERBOSE_CALLER_LOG LONG_CALLER_LOG
  1266.  
  1267.                Default: NO (use the short callerlog report format)
  1268.  
  1269.  
  1270.   ____________________________Keywords: Additional___________________________
  1271.  
  1272.   EXTENDED     YES|NO.  This keyword is used to clarify to RNet if your host
  1273.                is using or supporting more than 255 conferences.  This may or
  1274.                may not be needed depending on the mail door you are using on
  1275.                your host.  If you are using MarkMail 2.xx or KMail with
  1276.                conferences numbered higher than 255 on your host (your local
  1277.                conference numbers are not important), you may need to specify
  1278.                EXTENDED=YES to be sure RNet understands.  RNet should be able
  1279.                to determine this for itself, but since as of the time of this
  1280.                release no mail door supports this yet, it is difficult to
  1281.                test.
  1282.                SYN: EXTENDED_CONFS EXTENDEDCONFS
  1283.  
  1284.   RUN          You may specify as many RUN statements in your configuration
  1285.                file as desired.  When RNet encounters the RUN keyword in the
  1286.                configuration file, it takes the text following the equals
  1287.                sign and executes a DOS COMMAND.COM/C shell with the command
  1288.                specified.  This is useful if you want to be sure RNet does
  1289.                something every time it is run without having to remember to
  1290.                run a batch file to access RNet.  A common use is to force
  1291.                RNEt to update its RNETCONF file with any changes to your
  1292.                conference setup since the last time it ran.
  1293.  
  1294.                Example: RUN=PCBCONF d:\pcb\main\cnames -i
  1295.                Example: RUN=IF EXIST *.QW? COPY *.QW? D:\HOLDQWKS
  1296.  
  1297.  
  1298. RNET.DOC                                                               Page 25
  1299.  
  1300.  
  1301.  
  1302.   ____________________________Initial Installation___________________________
  1303.  
  1304.   [This assumes that you have already arranged NetStatus with your host BBS
  1305.   and is the most common setup design folks use for RNet.  Additional steps
  1306.   (such as step 5) are added to account for differing situations.]
  1307.  
  1308.    1.  Create a directory for RNet.  Copy all the files from the distribution
  1309.        ZIP into this directory.  Later, you can delete any files you don't
  1310.        need or want (such as the SAMPLE?.CFG files).
  1311.  
  1312.    2.  Run either PCBCONF.EXE or PROCONF.EXE to create the RNETCONF file --
  1313.        RNet will not operate without this file being created.  If running
  1314.        PCBoard 14.x, use PCBCONF.  If running ProDoor 2.9+, use PROCONF.
  1315.  
  1316.          Syntax:  PCBCONF D:\DIR\CNAMES
  1317.          Syntax:  PROCONF D:\DIR\CONFINFO
  1318.  
  1319.    3.  Use a text editor such as QEdit or Edlin to create a HOST_ID.CFG file.
  1320.        If desired, use one of the SAMPLE?.CFG files as a starting point by
  1321.        renaming or copying it to the appropriate HOST_ID.CFG name.
  1322.  
  1323.          Example:  FTL.CFG      (Faster-Than-Light BBS as host)
  1324.          Example:  TRP.CFG      (The Right Place<tm> BBS as host)
  1325.          Example:  EXECNET.CFG  (Executive Network BBS as host)
  1326.  
  1327.        See the documentation above for more information on HOST_ID.CFG files.
  1328.  
  1329.    4.  Run RNet to create a pointer file.  RNet will automatically check
  1330.        the pointers against the messagebases after the pointer file is
  1331.        created.  The TOP operation is selected in case you have another
  1332.        utility you have been using for echomail so that messages will not be
  1333.        lost (see step 5).
  1334.  
  1335.          Syntax:  RNET TOP HOST_ID
  1336.  
  1337.    5.  If you were previously running another echomail utility, run it one
  1338.        last time to export any messages which need to be exported.  This is
  1339.        done _after_ step 4 so that any messages entered on another node
  1340.        between steps 4 and 5 will not be lost.
  1341.  
  1342.        If you were previously running QNet or another QWK packet echomail
  1343.        package, place the newly created REP (if there is one) where you have
  1344.        instructed RNet to look for/create REPs.  Commonly, this is either the
  1345.        RNet directory or the directory where your terminal program expects to
  1346.        find files for uploading.  Assuming you have RNet set to APPEND to
  1347.        REPs (default configuration), RNet will append any new outgoing
  1348.        messages to this REP the next time you run an EXPORT.
  1349.  
  1350.        If you were previously running a non-QWK compatible echomail package,
  1351.        you should upload/send/do-whatever-is-needed the file up to your host
  1352.        -- it might be convenient to do this while handling step 6.
  1353.  
  1354.    6.  Call the host system and configure the mail door.  Open the mail door
  1355.        you will be using for your echomail transfers.  Configure the mail
  1356.        door for the conferences you will be transferring -- set all pointers
  1357.        as appropriate, usually by "topping" all conferences.
  1358.  
  1359. RNET.DOC                                                               Page 26
  1360.  
  1361.  
  1362.  
  1363.        If you were previously using a QWK packet system, you probably need
  1364.        change nothing.  If you have a REP file for upload, you should upload
  1365.        it now.
  1366.  
  1367.    7.  Download a QWK packet.  You might want to change the pointers on all
  1368.        of the conferences you will be echoing such that you get SOMETHING in
  1369.        every conference.  In other words, set the pointer for each conference
  1370.        to one less than the high message number.  This should result in you
  1371.        getting one message per conference.  Download the QWK to the directory
  1372.        where you have told RNet to expect to find QWK's.
  1373.  
  1374.    8.  Logoff the host, go back to the RNet directory and execute a RNET
  1375.        IMPORT HOST_ID -- this assumes that you did get a QWK packet while in
  1376.        the mail door.  Watch the operation to be sure that nothing is wrong
  1377.        (conferences go where they should, work directory exists, etc).  Make
  1378.        any changes to the HOST_ID.CFG as needed.  After successful IMPORT of
  1379.        the QWK packet, be sure to delete it (if you have KILLQWK=NO).
  1380.  
  1381.    9.  Setup an automated method (suggested) of transferring the mail.
  1382.        Usually this is done via EVENT.SYS and a communications program script
  1383.        or perhaps a package such as RoboComm.
  1384.  
  1385.   10.  If you have any questions or problems, you host will probably have the
  1386.        quickest answers and can help.  If RNet refuses to run or has a
  1387.        problem, it will report (both to the screen and to an ERROR.LOG file)
  1388.        where it is having difficulties.  Check drive & directory entries
  1389.        carefully, as they are the most common problem causing elements.
  1390.  
  1391.  
  1392. RNET.DOC                                                               Page 27
  1393.  
  1394.  
  1395.  
  1396.   _________________________Copyrights and Trademarks_________________________
  1397.  
  1398.   All programs mentioned are copyrighted and/or trademarked by their
  1399.   respective holders.  Please refer to each respective program to determine
  1400.   the actual copyright/trademark holder as appropriate or needed.
  1401.  
  1402.  
  1403.   ______________________________Acknowledgments______________________________
  1404.  
  1405.   Roger Sligar -- Sysop of The Right Place<tm> in Atlanta.  He gets top
  1406.                   billing around here for all his support/prodding/effort and
  1407.                   uncountable hours of chasing down bugs/messages across the
  1408.                   world!  It was the desire to safely and dependably run a
  1409.                   couple echo's with TRP that was the invention of RNet.
  1410.  
  1411.   Mark Herring -- Inventor of the QWK format and offline readers/maildoors.
  1412.                   Without his original ideas to bring offline readers to the
  1413.                   PCBoard market, RNet would never have existed.
  1414.  
  1415.   ILink        -- (formally InterLink).  A good international network of good
  1416.                   folks who very quickly adopted RNet into wide use.  It is
  1417.                   for the continued growth of networks like ILink that RNet
  1418.                   is constantly being improved.
  1419.  
  1420.   ... and all the registered Sysops who are running RNet!  --  Thank you for
  1421.   your support and as always, please let me know of any ideas or suggestions
  1422.   you have!  I hope you and your users enjoy the wild and wonderful world of
  1423.   EchoConferences!
  1424.  
  1425.  
  1426.